home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / patches / fixslinks / makelink.doc < prev    next >
Text File  |  1996-04-07  |  3KB  |  87 lines
  1.  
  2.                               makelink.TV 42.2
  3.                               ~~~~~~~~~~~~~~~~
  4.  
  5. Overview:
  6.  
  7.   Well, in the development of AmiNIX I needed a quick program to be capable
  8.   of making soft links (symbolic links under AmiNIX). Since with 3.1 C=
  9.   still hadn't made makelink soft-link capable, I wrote makelink.TV to
  10.   replace it. This functions identically to C='s makelink, except (for now)
  11.   the hard link loop detection isn't implemented. But it's a bit smaller
  12.   than C='s makelink V37, and also supports soft links. This version is also
  13.   pure and can be made resident just like C='s makelink.
  14.  
  15.   I hope to add the loop detection to make it 100% C= makelink compatible,
  16.   but until then you should be smart enough not to link a directory to
  17.   a directory link underneath itself. :) WARNING: Making a hard link loop
  18.   can confuse the file system if you keep traversing the links...
  19.  
  20.   A note about using soft links: Many programs may fail when using soft
  21.   links as implemented in the V37+ dos.library. Soft links are only
  22.   directly resolved if they are last in the path (i.e. if `link' is a link,
  23.   and you access `link/file', it won't work). But if the program traverses
  24.   the soft link and then locks the file underneath it, it will work. Note
  25.   that soft links to files are therefore fine, but soft links to directories
  26.   may or may not work. It is known that the Workbench and DirWork 2.1 both
  27.   correctly handle soft links to directories. There are PD patches to
  28.   dos.library to fix this bug, but I'm not aware of their names.
  29.  
  30. Files:
  31.  
  32.   MakeLink        Binary
  33.   MakeLink.doc        This file!
  34.  
  35. Template:
  36.  
  37.   FROM/A,TO/A,HARD/S,FORCE/S,SOFT/S
  38.  
  39. Usage:
  40.  
  41.   makelink <from> <to> [hard] [force] [soft]
  42.  
  43. Options:
  44.  
  45.   FROM:
  46.     This is the name of the link to create.
  47.  
  48.   TO:
  49.     This is the file/directory to link to. If this is a soft link, this
  50.     should be either an absolute path or a path relative to the FROM's
  51.     directory. If this is a hard link, this can be any path as it is
  52.     resolved at makelink-time.
  53.  
  54.   HARD:
  55.     This switch is basically ignored, but produces an error if you specify
  56.     it and SOFT at the same time. The default is hard links unless you
  57.     specify SOFT.
  58.  
  59.   FORCE:
  60.     This switch must be supplied to create a hard link to a directory.
  61.     NOTE about hard links to dirs! Many directory utilities, DirWork among
  62.     them, will recognize link-dirs as real directories, and if you hit the
  63.     recursive-delete button, it will traverse the directory. However, the
  64.     CLI Delete command handles directory hard links properly (it will delete
  65.     the link only).
  66.  
  67.   SOFT:
  68.     Specify this option to make a soft link. In this case, the keyword
  69.     FORCE is ignored.
  70.  
  71. Revision History:
  72.  
  73.   42.1 (16-Nov-94):
  74.     Internal release. Used version 42.x because this is the popular version
  75.     number for 3.1-compatible commands and utilities of the same name.
  76.  
  77.   42.2 (18-Nov-94):
  78.     First public release.
  79.     Fixed hard link Enforcer hit. Not checking the return value of Lock()
  80.     and attempting to Examine() NULL. :-P
  81.     Fixed CloseLibrary() bug. (D'oh!)
  82.  
  83. The Author:
  84.  
  85.   Todd Vierling (amigagod@grove.ufl.edu).
  86.   As of August 1995 this e-mail address is correct.
  87.